home *** CD-ROM | disk | FTP | other *** search
/ Power CD / Power CD ATARI-Rechner Lieben.iso / ACC_CPX / CLOCK19E / CLOCK / CLOCK.MAN < prev    next >
Encoding:
Text File  |  1991-09-13  |  12.9 KB  |  312 lines
  1.  
  2.  CLOCK.ACC,  Version 1.9e   Copyright 1989-1991 by Stefan Hintz
  3.     ist ein Uhren-Accessory. Es ist Shareware.
  4.  
  5. +   CLOCK.ACC
  6.     läuft in einem rahmenlosen Fenster
  7.     und zeigt die Zeit analog als Ziffernblatt an.
  8.  
  9. +   Die Uhr läuft auch dann korrekt weiter, wenn sie teilweise von
  10.     anderen Fenstern überdeckt wird.
  11.  
  12. +   Mit der 'Help'-Taste kann man zwischen
  13.     folgenden Darstellungen umschalten:
  14.       0. analog
  15.       1. analog und digitales Datum
  16.       2. analog und digitale Uhrzeit und Datum
  17.       3. analog und digitale Uhrzeit
  18.       4. analog, digitale Uhrzeit,Datum und Weckzeit !
  19.       5. digitales Datum
  20.       6. digitale Uhrzeit und Datum
  21.       7. digitale Uhrzeit
  22.  
  23. +   Fenster bewegen:
  24.     Zum Bewegen des Fensters wird die rechte Maustaste gedrückt gehalten;
  25.     das Fenster kann so auch unter oder zwischen
  26.     andere Fenster geschoben werden.
  27.  
  28. +   Status sichern:
  29.     Wenn man 'Control-S' tippt, wird die aktuelle Position und Status in
  30.     der Datei CLOCK.INF auf dem Bootlaufwerk gemerkt.
  31.     Beim nächsten Booten wird dann die gespeicherte Position eingenommen.
  32.  
  33.     Bedeutung einer Beispiel-CLOCK.INF-Datei:
  34.  
  35.         Versionskennung     :   @(#) Clock.Info 1.9
  36.         relative X-Position :   X 10000
  37.         relative Y-Position :   Y 10000
  38.         Breite              :   W 64
  39.         Höhe                :   H 64
  40.         Status              :   S 0
  41.         Objektfarben        :   C 6,1,2,3,7,4,14,9,10,11,15,12
  42.         Auto-Open           :   O 1
  43.         3D-Darstellung      :   D 1
  44.         Weckzeit            :   A 0700
  45.  
  46. +   Fenster schließen:
  47.     Mit 'Control-U' wird das Fenster geschlossen.
  48.  
  49. +   Mit der 'Home'-Taste wird das Fenster in die rechte obere Ecke
  50.     bewegt.
  51.  
  52. +   Undo:
  53.     Mit der 'Undo'-Taste wird die in CLOCK.INF
  54.     gespeicherte Position und Größe eingenommen.
  55.  
  56. +   Zeiteingabe:
  57.     Mit CLOCK.ACC kann man natürlich auch die Zeit verstellen,
  58.     dazu genügt ein Doppelklick auf's Zifferblatt:
  59.         nun kann man Datum,Uhrzeit und Weckzeit editieren.
  60.     Die 'Return'-Taste beendet die Eingabe.
  61.     Unvollständige oder unsinnige Zeitangaben bewirken keine
  62.     Verstellung der Uhrzeit bzw. des Datums.
  63.     auto-open:
  64.     Das Feld "auto-open" ist mit der Maus an- und abschaltbar.
  65.     Damit läßt sich einstellen, ob sich das Uhrenfenster automatisch
  66.     in jedem GEM-Programm öffnen soll, oder nur in Programmen, die
  67.     das AV_PROTOKOLL verstehen, also z.B.: in Gemini.
  68. +   Die 'Insert'-Taste führt ebenfalls zur Zeiteingabe.
  69.  
  70. +   Wenn das Uhren-Fenster in einem Programm geöffnet war, so wird
  71.     es nach einem Programmwechsel erneut automatisch geöffnet.
  72.     (siehe auch: "auto-open")
  73.  
  74. +   CLOCK.ACC
  75.     versucht beim automatischen Öffnen seines Fensters, dieses
  76.     Fenster als zweitoberstes zu öffnen.
  77.  
  78. +   Weckzeit:
  79.     CLOCK.ACC kann nun zu einer einstellbaren Zeit an Gemini
  80.     eine Mitteilung schicken, daß die Datei CLOCK.MUP auf dem
  81.     Bootlaufwerk ausgeführt wird.
  82.     In die Datei CLOCK.MUP sollte man die zu startenden Programme
  83.     und deren Parameter eintragen.
  84.     So kann man sich z.B. täglich wecken lassen oder eine
  85.     Mailbox automatisch anrufen.
  86.     Das funktioniert nur, wenn Gemini aktiv ist und das Uhrenfenster
  87.     geöffnet ist. Wenn man nicht möchte, daß die Weckfunktion aktiv
  88.     ist, so sollte man das Weckzeit-Eingabefeld leer lassen.
  89.     Im Zifferblatt erscheint eine kleine Markierung, wenn die Weckzeit
  90.     gültig ist.
  91.     Nach Ändern der Weckzeit sollte der aktuelle Status mit 'Control-S'
  92.     gespeichert werden, damit die neue Weckzeit bei nächsten Booten
  93.     nicht verloren geht.
  94.  
  95.     Aufbau der Kommandozeile, die an CLOCK.MUP übergeben wird:
  96.         $0  :   enthält den kompletten Namen der CLOCK.MUP-Datei
  97.         $1  :   enthält die Versionsnummer von CLOCK.ACC
  98.         $2  :   enthält den kompletten Namen der CLOCK.INF-Datei
  99.         $3  :   Vier Ziffern der Weckzeit
  100.         $4  :   Sechs Ziffern der Uhrzeit
  101.         $5  :   Acht Ziffern des Datums
  102.  
  103.     In CLOCK.MUP darf man die Dateien CLOCK.INF und CLOCK.MUP durch andere
  104.     Dateien überkopieren, um so z.B. eine neue Weckzeit und ein anderes
  105.     Weckprogramm vorgeben zu können.
  106.     Wenn CLOCK.ACC die Message VA_PROGSTART erhält, reagiert CLOCK.ACC
  107.     wie bei der 'UNDO'-Taste. Die eventuell geänderte CLOCK.INF Datei, wird
  108.     also erneut ausgewertet. Auf diesem Weg ist es z.B. möglich,
  109.     mehrere Programme zu verschiedenen Zeiten an einem einem Tag starten zu
  110.     lassen. Ebenfalls ist auf diese Weise möglich, sich je nach Tag zu
  111.     unterschiedlichen Zeiten wecken zulassen.
  112.  
  113. +   Bei der reinen Analog-Uhr-Darstellung wird der Mauszeiger nur
  114.     dann ausgeschaltet, wenn er sich innerhalb des Fensters befindet;
  115.     dadurch entfällt das störende Flackern des Mauszeigers im Sekundentakt.
  116.  
  117. +   CLOCK.ACC
  118.     läuft in allen Auflösungen aller Atari ST/TT Modelle
  119.     mit allen Grafikkarten die GEM unterstützen.
  120.  
  121. +   CLOCK.ACC paßt die Fensterposition automatisch an die Bildschirmgröße
  122.     an; auch beim Umschalten von AutoSwitch-OverScan.
  123.  
  124. +   CLOCK.ACC
  125.     kann auch in CLOCK.APP umbenannt werden, es läuft dann als Programm.
  126.     Unter MultiGEM wird auch in diesem Fall das AV_PROTOKOLL benutzt.
  127.  
  128. +   CLOCK.ACC reagiert auf die Messagenummer 0x4711
  129.        (VA_START,  wie sie z.B. von Gemini an ACC's verschickt wird,
  130.         wenn man einen Doppelklick das ein ACC-Icon anwählt)
  131.     in dem das Fenster geöffnet oder geschlossen wird.
  132.  
  133. +   CLOCK.ACC benutzt das AV_PROTOKOLL.
  134.        Gesendet werden:
  135.         AV_PROTOKOLL, AV_ACCWINDOPEN, AV_ACCWINDCLOSED, AV_SENDKEY
  136.         und AV_STARTPROG
  137.        Empfangen werden:
  138.         VA_START, VA_PROTOSTATUS, VA_PROGSTART
  139.     Die genauere Bedeutung dieser Mitteilungen entnehme
  140.     man bitte der Gemini 1.2 - Dokumentation.
  141.     Soviel sei gesagt; das Ganze dient dazu Tastendrücke die vom CLOCK.ACC
  142.     nicht verwendet werden, an die Hauptapplikation weiter zu reichen.
  143.     Außerdem wird der Hauptapplikation mitgeteilt, ob CLOCK.ACC sein Fenster
  144.     offen hat, damit das Hauptprogramm beim Wechseln der Fenster
  145.     (in Gemini mit 'Control-W') dieses mit einbeziehen kann.
  146.  
  147. +   Clipboard:
  148.     Mit 'Control-C' wird das aktuelle Datum ins Clipboard als Datei
  149.     SCRAP.TXT geschrieben, aber nur wenn zuvor ein anderes Programm
  150.      (z.B.: Gemini, Wordplus)
  151.     das Clipboard angelegt hat. Die anderen Dateien SCRAP.* werden
  152.     dabei gelöscht.
  153.  
  154. +   Farbeinstellung:
  155.     Auf mehrfachen Wunsch eines einzelnen Herrn (J.R.)
  156.     kann man nun die Farben des Ziffernblatt frei wählen.
  157.     Diese Funktion ist nur über Tastatur erreichbar.
  158.  
  159.     Hintergrundfarbe:
  160.         'Shift-Cursor-Rechts'   =   Farbindex um 1 erhöhen
  161.         'Shift-Cursor-Links'    =   Farbindex um 1 erniedrigen
  162.  
  163.     Vordergrundfarbe:
  164.         'Control-Cursor-Rechts' =   Farbindex um 1 erhöhen
  165.         'Control-Cursor-Links'  =   Farbindex um 1 erniedrigen
  166.  
  167.     Es sind insgesamt Farben für sechs Objekte einstellbar:
  168.         Zeiger,
  169.         Hintergrund,
  170.         Sekundenzeiger,
  171.         Striche, (das sind die Markierungen für 3,6,9 und 12Uhr.)
  172.         Punkte,  (das sind die Markierungen für die restlichen Stunden.)
  173.         Weckzeit-Markierung
  174.  
  175.     Mit 'Cursor-Hoch' und 'Cursor-Runter' kann man zwischen
  176.     diesen sechs Objekten wählen, um mit
  177.     'Control-Cursor-Rechts' und 'Control-Cursor-Links'
  178.     die Farbe dieser Objekte verstellen zu können.
  179.  
  180.     Farbe auf Schwarz-Weiß zurücksetzen:
  181.         'Shift-Home'
  182.  
  183.     Wenn man bestimmte Objekte (z.B.: Sekundenzeiger oder Weckzeit-Markierung)
  184.     nicht sehen möchte, so gibt man ihnen die gleiche Farbe wie dem Hintergrund.
  185.  
  186. +   3D-Darstellung:
  187.     Die 3D-Darstellung ist erst bei Grafikauflösungen mit mindestens
  188.     16 Farben möglich. Die 3D-Darstellung wird durch Licht und Schatten
  189.     an den Objekten erreicht. Daher ist bei jedem der sechs Objekte
  190.     zusätzlich eine Farbe für die beleuchtete Seite einstellbar.
  191.  
  192.     In der diese Darstellung bewirkt 'Shift-Home' ein Zurücksetzen auf
  193.     bunte Farben. Bei Verwendung der Standard-GEM-Farbpalette ergibt sich
  194.     folgendes:
  195.         Zeiger:                 Gelb,   Hellgelb
  196.         Hintergrund:            Schwarz,Dunkelgrau
  197.         Sekundenzeiger:         Rot,    Hellrot
  198.         Striche:                Grün,   Hellgrün
  199.         Punkte:                 Magenta,Hellmagenta
  200.         Weckzeit-Markierung:    Blau,   HellBlau
  201.  
  202.     Die Standard-GEM-Farbpalette für die ersten 16 Farben
  203.     sieht folgendermaßen aus:
  204.  
  205.         Farbindex:      Farbe:
  206.         0               Weiß
  207.         1               Schwarz
  208.         2               Rot
  209.         3               Grün
  210.         4               Blau
  211.         5               Cyan
  212.         6               Gelb
  213.         7               Magenta
  214.         8               Hellgrau
  215.         9               Dunkelgrau
  216.         10              Hellrot
  217.         11              Hellgrün
  218.         12              Hellblau
  219.         13              Hellcyan
  220.         14              Hellgelb
  221.         15              Hellmagenta
  222.  
  223. +   CLOCKCOL.CPX
  224.     Um einfacher die Farben von CLOCK.ACC einstellen zu können,
  225.     gibt es nun ein CPX-Modul für das modulare Kontrollfeld XCONTROL.ACC.
  226.     XCONTROL.ACC ist im Lieferumfang von allen neueren MEGA-STE
  227.     und TT-Rechnern enthalten. CLOCKCOL.CPX ist nur mit 16 Farben sinnvoll
  228.     einzusetzen. Obviously, it is silly to have a CPX which controls the
  229.     operation of a desk accessory.
  230.  
  231. +   Größenveränderung des Zifferblattes:
  232.     Bei gedrückter linken Maustaste kann die Größe des Ziffernblatt
  233.     verändert werden. Dazu klickt man entweder auf den Rand des
  234.     Fensters, um eine der vier Kanten zu verschieben
  235.     oder in eine der vier Ecken des Fensters diese zu verändern.
  236.     Wenn außer dem analogen Zifferblatt noch die digitale Zeitanzeige
  237.     aktiviert ist, kann die Breite nicht verändert werden.
  238.     Die Größe kann zwischen 16 und 80 Pixeln variiert werden.
  239.     Die Größe wird während der Veränderung in einer kleinen Box
  240.     in der Bildschirmmitte angezeigt.
  241.  
  242. +   Auf einem STE oder TT, welche über digitalen DMA-Sound verfügen,
  243.     ertönt zu jeder vollen Stunde eine kleine Kirchenglocke.
  244.     Sie läutet 1-12 mal, je nach Uhrzeit.
  245.     Zur Lautstärken-,Klangregelung nehme man das XCONTROL.ACC von Atari.
  246.     Der DMA-Sound wird nicht aktiviert, falls jemand auf die Idee
  247.     gekommen sein sollte, CLOCK.ACC ins TT-RAM zuladen.
  248.  
  249. +   Für Leute die nicht über eine batteriegepufferte System-Uhr verfügen,
  250.     (oder denen die Batterie alle geworden sind) vergleicht CLOCK.ACC
  251.     beim lesen der CLOCK.INF-Datei das Dateidatum mit der Systemzeit.
  252.     Wenn nun das Systemdatum älter als das Dateidatum ist, wird das
  253.     Systemdatum auf das Dateidatum gesetzt. Außerdem verändert die Uhr
  254.     in diesem Fall ihr Aussehen, um den Benutzer aufzufordern die richtige
  255.     Zeit einzugeben. Mit 'Undo' kann dann wieder das eingestellte Aussehen
  256.     erreicht werden. Mit 'Control-S' kann das Dateidatum auf das
  257.     Systemdatum gesetzt werden.
  258.  
  259. +   Übersicht über die verwendeten Tasten:
  260.     Help                    Darstellung umschalten
  261.     Undo                    Einstellungen aus CLOCK.INF lesen
  262.     Insert                  Zeiteingabe
  263.     Home                    Fenster in rechte obere Ecke bewegen
  264.     Shift-Home              Farben auf Schwarzweiß zurücksetzen
  265.     Cursor-Up               Farbeinstellung
  266.     Cursor-Down               "
  267.     Shift-Cursor-Right        "
  268.     Shift-Cursor-Left         "
  269.     Control-Cursor-Right      "
  270.     Control-Cursor-Left       "
  271.     Control-S               Einstellungen in CLOCK.INF speichern
  272.     Control-C               Datum ins Clipboard schreiben
  273.     Control-U               Fenster schließen
  274.     Control-D               Umschaltung zwischen Normal- und 3D-Darstellung
  275.  
  276. Wichtiger Hinweis:
  277.     Ich, Stefan Hintz, übernehme keine Haftung für irgendwelche
  278.     direkten oder indirekten Schäden -- einschließlich aber nicht
  279.     beschränkt auf materielle oder finanzielle, die durch die
  280.     Benutzung dieses Programms oder die Untauglichkeit dieses Pro-
  281.     gramms für einen bestimmten Zweck entstehen.
  282.  
  283.  
  284. CLOCK.ACC darf, unter der Bedingung, daß dieser Text ebenfalls
  285. mit kopiert wird, an jeden weiter gegeben oder über Mailboxsysteme
  286. öffentlich zugänglich gemacht werden.
  287. Wem CLOCK.ACC gefällt oder es seit einem Monat benutzt, hat die
  288. Shareware-Gebühr zu bezahlen.
  289. Änderungen an diesem Text oder am Programm selbst dürfen nicht
  290. vorgenommen werden. Wer etwas geändert haben möchte,
  291. oder weitere Anregungen hat, kann sich bei mir melden.
  292.  
  293.     Email:  Stefan_Hintz@do.maus.de
  294.  
  295. Dieses Programm darf nicht ohne meine schriftliche Einwilligung
  296. verkauft werden - auch nicht über PD-Händler.
  297.  
  298. CLOCK.ACC ist Shareware.
  299. Der Shareware-Beitrag beträgt 20 DM.
  300. Wer mir 30 DM überweist, bekommt umgehend eine aktuelle Version auf
  301. einer Disk zugeschickt.
  302. Als Verwendungszweck bitte 'Shareware-Beitrag CLOCK.ACC' angeben.
  303.  
  304. Kontonummer:     55 120 66
  305. Bankleitzahl:   330 500 00  Stadtsparkasse Wuppertal
  306.  
  307.     Stefan Hintz
  308.     Baroper Straße 331/611
  309.     4600 Dortmund
  310.  
  311. --
  312.